<!doctype html>
<html>
<head>
<meta charset="utf-8"/>
<title>ua &lsaquo; KISSY Docs</title>
<link rel="stylesheet" href="../assets/base-min.css" />
<link rel="stylesheet" href="../assets/docs.css" />
</head>
<body class="w866">
<div id="header">
    <a class="logo" href="../index.html"><img src="../assets/logo.png" alt="KISSY" width="138" height="74" /></a>
    <p class="rel-nav">
        <a href="http://github.com/kissyteam/kissy/tree/master/src/ua/ua.js"><code>ua.js</code></a>
    </p>
</div>
<div id="content" class="layout grid-s232m0">
    <div class="col-main">
        <div class="main-wrap">

            <div class="section summary">
                <p>通过 <code>KISSY.UA</code>, 你可以获取浏览器等用户代理信息。属性值遵循以下规则：</p>
                <ol>
                    <li>表示当前引擎或浏览器的版本。版本号 1.2.3.4 会转换为数值 1.234</li>
                    <li>如果不是当前引擎或浏览器，返回 0</li>
                    <li>如果当前引擎或浏览器的版本号无法准确判定，返回 0.1</li>
                </ol>
                <p class="tips">注意：</p>
                <ol>
                    <li><code>UA.core</code> 返回字符串，目前支持 trident, webkit, gecko, presto 四大浏览器内核。</li>
                    <li><code>UA.shell</code> 返回字符串，比如 firefox, opera, chrome, ie, safari</li>
                    <li><code>UA.mobile</code> 返回字符串，目前支持 apple, nokia, android, opera mini/mobile 等设备/浏览器的探测。</li>
                </ol>
            </div>

            <div class="section">
                <h3 id="methods">Properties</h3>

                <div class="member prop">
                    <h4><a name="prop_trident">trident</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>trident 的版本号。</p>
                        <p class="notice">IE 浏览器 8 系列以下都无法准确探测 Trident 内核的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_webkit">webkit</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>webkit 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_gecko">gecko</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>gecko 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_presto">presto</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>presto 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_chrome">chrome</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>chrome 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_safari">safari</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>safari 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_firefox">firefox</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>firefox 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_ie">ie</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>ie 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_opera">opera</a> - <code>Number</code></h4>
                    <div class="detail">
                        <p>opera 的版本号。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_mobile">mobile</a> - <code>String</code></h4>
                    <div class="detail">
                        <p>mobile 的标志符。</p>
                        <p class="notice">若无法探测或非移动设备浏览器，将返回空字符串。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_core">core</a> - <code>String</code></h4>
                    <div class="detail">
                        <p>core 的标志符。此标识符表示浏览器的内核标识。</p>
                        <p class="notice">若浏览器内核不是 trident, webkit, gecko, presto 将返回空字符串。</p>
                    </div>
                </div>

                <div class="member prop">
                    <h4><a name="prop_shell">shell</a> - <code>String</code></h4>
                    <div class="detail">
                        <p>shell 的标志符。此标识符表示用户所用浏览器的外壳标识。</p>
                        <p class="tips">使用说明：</p>
                        <ol>
                            <li>此处的外壳表示广义的外壳，即 IE, Firefox, Chrome, Opera, Safari 等浏览器都属于外壳。可以利用此标识符直接识别浏览器类型。</li>
                            <li>可以首先使用 <code>UA.shell</code> 返回的标识符判断当前浏览器类型，若需浏览器具体版本信息，可以再通过 <code>UA[UA.shell]</code> 取出版本号。</li>
                            <li>对于众多国产浏览器外壳的，请跳转到 <a href="./ua-extra.html">ua-extra</a> 查看具体探测方法。</li>
                        </ol>
                    </div>
                </div>

            </div>
        </div>
    </div>
    <div class="col-sub">
        <div class="sub-wrap">
            <div class="loc">
                <a href="../index.html">home</a> &rsaquo;
                <a href="index.html">ua</a> &rsaquo;
                ua :
            </div>
            <div class="toc">
                <h3>Properties</h3>
                <ul>
                    <li><a href="#prop_trident">trident</a></li>
                    <li><a href="#prop_webkit">webkit</a></li>
                    <li><a href="#prop_gecko">gecko</a></li>
                    <li><a href="#prop_presto">presto</a></li>
                    <li><a href="#prop_chrome">chrome</a></li>
                    <li><a href="#prop_safari">safari</a></li>
                    <li><a href="#prop_firefox">firefox</a></li>
                    <li><a href="#prop_ie">ie</a></li>
                    <li><a href="#prop_opera">opera</a></li>
                    <li><a href="#prop_mobile">mobile</a></li>
                    <li><a href="#prop_core">core</a></li>
                    <li><a href="#prop_shell">shell</a></li>
                </ul>
            </div>
            <div class="toc">
                <h3>Sub modules</h3>
                <ul>
                    <li><a href="ua-extra.html">ua-extra</a></li>
                </ul>
            </div>
        </div>
    </div>
</div>
<div id="footer">
    <p class="copyright">&copy; 2009 - 2029 KISSY UI LIBRARY</p>
</div>
</body>
</html>
